home *** CD-ROM | disk | FTP | other *** search
/ Belgian Amiga Club - ADF Collection / BS1 part 19.zip / BS1 part 19 / power Window v2.5.adf / TB / README < prev   
Text File  |  1988-09-15  |  2KB  |  38 lines
  1. True BASIC:
  2. True BASIC support has been implemented in a standalone program called
  3. PW2TB.  It accepts the PW2 intermediate file format as input.  It outputs a
  4. file containing a subroutine which handles all of the allocation of the data
  5. structures via calls to a set of routines which allocate and then fill out
  6. the structures.  This set of routines is in the file called "PW2TBsupport"
  7. and the compiled version is in "PW2TBsupport*".  These routines use the
  8. Intuition functions AllocRemember and FreeRemember to control memory usage
  9. for EACH subroutine: every subroutine you generate will have its own
  10. Remember pointer as well as its own name, both taken from the name of the
  11. file generated.  Therefore, the True BASIC Toolkit software package is
  12. required.
  13.  
  14. To run the True BASIC converter (PW2TB), just run it.  It will bring up a
  15. file-requester asking you for a PW2 file to read in.  Pick the file and
  16. after PW2TB loads it, it will display it.  PW2TB will bring up a window
  17. letting you specify which filenames to generate and what "header" file to
  18. include.  The "header" file is any file which will be copied into the output
  19. file before code generation begins.  We suggest using some modification of
  20. the file provided, called "PW2TB.header".  This file contains the necessary
  21. LIBRARY and DECLARE DEF statements to compile and run a True BASIC program
  22. with PW2TB output, as well as an example program to open a screen, a window,
  23. attach menus, wait for input and then clean up.
  24.  
  25. The switch on the code generation requester of PW2TB called "SMALLER IMAGES"
  26. forces all CHIP memory allocations for Imagery to be cleared when allocated.
  27. Then when the initialization statements are written, if the statement is to
  28. force a memory word to 0, that statement is omitted because all of the CHIP
  29. memory allocated is already 0.  This can result in tremendous savings in code
  30. size.  Remember, Big Images result in Big Files, so we highly recommend the
  31. use of this switch; however, it can make hand-editing of Imagery much more
  32. difficult.
  33.  
  34. InovaTools1 glue routines for use with True BASIC are not yet available, but
  35. are in development.
  36.  
  37. To quit PW2TB, just press the CANCEL button on the file-requester.
  38.